@buenojs/bueno 0.8.10 → 0.8.11

package/dist/config/types.js

@@ -0,0 +1,443 @@
+/**
+ * Configuration type definitions for Bueno Framework
+ */
+// ============= Default Configuration =============
+export const DEFAULT_CONFIG = {
+    server: {
+        port: 3000,
+        host: "localhost",
+        development: false,
+    },
+    database: {
+        url: undefined,
+        poolSize: 10,
+        enableMetrics: true,
+        slowQueryThreshold: 100,
+    },
+    cache: {
+        driver: "memory",
+        url: undefined,
+        ttl: 3600,
+        keyPrefix: "",
+        enableMetrics: true,
+    },
+    jobs: {
+        enabled: false,
+        driver: "memory",
+        url: undefined,
+        keyPrefix: "jobs:",
+        concurrency: 10,
+        maxRetries: 3,
+        retryDelay: 1,
+        batchSize: 10,
+        pollInterval: 1000,
+        jobTimeout: 300000,
+        enableMetrics: true,
+    },
+    template: {
+        enabled: true,
+        basePath: "resources/templates",
+        cache: {
+            enabled: true,
+            ttl: 3600,
+            maxSize: 100,
+        },
+        watch: false,
+        defaultFormat: "html",
+        channelVariantMap: {
+            email: "email",
+            sms: "sms",
+            push: "push",
+            whatsapp: "whatsapp",
+            web: "web",
+        },
+    },
+    notification: {
+        enabled: false,
+        enableMetrics: true,
+        queue: false,
+        defaultChannel: "email",
+        email: {
+            enabled: true,
+            driver: "smtp",
+            from: "noreply@example.com",
+            fromName: "Bueno App",
+            dryRun: false,
+        },
+        sms: {
+            enabled: false,
+            driver: "twilio",
+            dryRun: false,
+        },
+        whatsapp: {
+            enabled: false,
+            driver: "twilio",
+            dryRun: false,
+        },
+        push: {
+            enabled: false,
+            driver: "firebase",
+            dryRun: false,
+        },
+    },
+    i18n: {
+        enabled: false,
+        defaultLocale: "en",
+        supportedLocales: ["en"],
+        basePath: "resources/i18n",
+        fallbackToDefault: true,
+        cookieName: "bueno_locale",
+        cookieMaxAge: 31536000,
+        watch: false,
+    },
+    logger: {
+        level: "info",
+        pretty: true,
+        output: "console",
+    },
+    health: {
+        enabled: true,
+        healthPath: "/health",
+        readyPath: "/ready",
+    },
+    metrics: {
+        enabled: true,
+        collectInterval: 60000,
+        maxHistorySize: 100,
+    },
+    telemetry: {
+        enabled: false,
+        serviceName: "bueno-app",
+        endpoint: undefined,
+        sampleRate: 1.0,
+    },
+    frontend: {
+        devServer: false,
+        hmr: true,
+        port: 3001,
+    },
+};
+export const ENV_MAPPINGS = [
+    // Server
+    {
+        envVar: "BUENO_PORT",
+        configKey: "server.port",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    { envVar: "BUENO_HOST", configKey: "server.host" },
+    {
+        envVar: "BUENO_DEV",
+        configKey: "server.development",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "PORT",
+        configKey: "server.port",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    { envVar: "HOST", configKey: "server.host" },
+    // Database
+    { envVar: "DATABASE_URL", configKey: "database.url" },
+    { envVar: "BUENO_DATABASE_URL", configKey: "database.url" },
+    {
+        envVar: "BUENO_DB_POOL_SIZE",
+        configKey: "database.poolSize",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_DB_METRICS",
+        configKey: "database.enableMetrics",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_DB_SLOW_QUERY",
+        configKey: "database.slowQueryThreshold",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    // Cache
+    { envVar: "REDIS_URL", configKey: "cache.url" },
+    { envVar: "BUENO_REDIS_URL", configKey: "cache.url" },
+    { envVar: "BUENO_CACHE_DRIVER", configKey: "cache.driver" },
+    {
+        envVar: "BUENO_CACHE_TTL",
+        configKey: "cache.ttl",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    { envVar: "BUENO_CACHE_PREFIX", configKey: "cache.keyPrefix" },
+    // Jobs
+    {
+        envVar: "BUENO_JOBS_ENABLED",
+        configKey: "jobs.enabled",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_JOBS_DRIVER", configKey: "jobs.driver" },
+    { envVar: "BUENO_JOBS_URL", configKey: "jobs.url" },
+    {
+        envVar: "BUENO_JOBS_CONCURRENCY",
+        configKey: "jobs.concurrency",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_JOBS_MAX_RETRIES",
+        configKey: "jobs.maxRetries",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_JOBS_RETRY_DELAY",
+        configKey: "jobs.retryDelay",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_JOBS_BATCH_SIZE",
+        configKey: "jobs.batchSize",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_JOBS_POLL_INTERVAL",
+        configKey: "jobs.pollInterval",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_JOBS_TIMEOUT",
+        configKey: "jobs.jobTimeout",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    // Template
+    {
+        envVar: "BUENO_TEMPLATE_ENABLED",
+        configKey: "template.enabled",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_TEMPLATE_BASE_PATH", configKey: "template.basePath" },
+    {
+        envVar: "BUENO_TEMPLATE_CACHE_ENABLED",
+        configKey: "template.cache.enabled",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_TEMPLATE_CACHE_TTL",
+        configKey: "template.cache.ttl",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_TEMPLATE_CACHE_MAX_SIZE",
+        configKey: "template.cache.maxSize",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_TEMPLATE_WATCH",
+        configKey: "template.watch",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_TEMPLATE_DEFAULT_FORMAT",
+        configKey: "template.defaultFormat",
+    },
+    // Notification
+    {
+        envVar: "BUENO_NOTIFICATION_ENABLED",
+        configKey: "notification.enabled",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_NOTIFICATION_METRICS",
+        configKey: "notification.enableMetrics",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_NOTIFICATION_QUEUE",
+        configKey: "notification.queue",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_NOTIFICATION_DEFAULT",
+        configKey: "notification.defaultChannel",
+    },
+    // Email Channel
+    {
+        envVar: "BUENO_EMAIL_ENABLED",
+        configKey: "notification.email.enabled",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_EMAIL_DRIVER", configKey: "notification.email.driver" },
+    { envVar: "BUENO_EMAIL_FROM", configKey: "notification.email.from" },
+    { envVar: "BUENO_EMAIL_FROM_NAME", configKey: "notification.email.fromName" },
+    { envVar: "BUENO_EMAIL_API_KEY", configKey: "notification.email.apiKey" },
+    {
+        envVar: "BUENO_EMAIL_DRY_RUN",
+        configKey: "notification.email.dryRun",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_SMTP_HOST", configKey: "notification.email.smtp.host" },
+    {
+        envVar: "BUENO_SMTP_PORT",
+        configKey: "notification.email.smtp.port",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    { envVar: "BUENO_SMTP_USER", configKey: "notification.email.smtp.username" },
+    {
+        envVar: "BUENO_SMTP_PASSWORD",
+        configKey: "notification.email.smtp.password",
+    },
+    {
+        envVar: "BUENO_SMTP_SECURE",
+        configKey: "notification.email.smtp.secure",
+        transform: (v) => v === "true",
+    },
+    // SMS Channel
+    {
+        envVar: "BUENO_SMS_ENABLED",
+        configKey: "notification.sms.enabled",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_SMS_DRIVER", configKey: "notification.sms.driver" },
+    {
+        envVar: "BUENO_SMS_DRY_RUN",
+        configKey: "notification.sms.dryRun",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_SMS_ACCOUNT_SID", configKey: "notification.sms.accountSid" },
+    { envVar: "BUENO_SMS_AUTH_TOKEN", configKey: "notification.sms.authToken" },
+    { envVar: "BUENO_SMS_FROM_NUMBER", configKey: "notification.sms.fromNumber" },
+    // WhatsApp Channel
+    {
+        envVar: "BUENO_WHATSAPP_ENABLED",
+        configKey: "notification.whatsapp.enabled",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_WHATSAPP_DRIVER",
+        configKey: "notification.whatsapp.driver",
+    },
+    {
+        envVar: "BUENO_WHATSAPP_DRY_RUN",
+        configKey: "notification.whatsapp.dryRun",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_WHATSAPP_ACCOUNT_SID",
+        configKey: "notification.whatsapp.accountSid",
+    },
+    {
+        envVar: "BUENO_WHATSAPP_AUTH_TOKEN",
+        configKey: "notification.whatsapp.authToken",
+    },
+    {
+        envVar: "BUENO_WHATSAPP_BUSINESS_PHONE",
+        configKey: "notification.whatsapp.businessPhoneNumber",
+    },
+    // Push Channel
+    {
+        envVar: "BUENO_PUSH_ENABLED",
+        configKey: "notification.push.enabled",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_PUSH_DRIVER", configKey: "notification.push.driver" },
+    {
+        envVar: "BUENO_PUSH_DRY_RUN",
+        configKey: "notification.push.dryRun",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_PUSH_SERVER_KEY", configKey: "notification.push.serverKey" },
+    {
+        envVar: "BUENO_PUSH_CERTIFICATE_PATH",
+        configKey: "notification.push.certificatePath",
+    },
+    // i18n
+    {
+        envVar: "BUENO_I18N_ENABLED",
+        configKey: "i18n.enabled",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_I18N_DEFAULT_LOCALE", configKey: "i18n.defaultLocale" },
+    {
+        envVar: "BUENO_I18N_SUPPORTED_LOCALES",
+        configKey: "i18n.supportedLocales",
+        transform: (v) => v.split(",").map((s) => s.trim()),
+    },
+    { envVar: "BUENO_I18N_BASE_PATH", configKey: "i18n.basePath" },
+    {
+        envVar: "BUENO_I18N_FALLBACK",
+        configKey: "i18n.fallbackToDefault",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_I18N_COOKIE_NAME", configKey: "i18n.cookieName" },
+    {
+        envVar: "BUENO_I18N_COOKIE_MAX_AGE",
+        configKey: "i18n.cookieMaxAge",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_I18N_WATCH",
+        configKey: "i18n.watch",
+        transform: (v) => v === "true",
+    },
+    // Logger
+    { envVar: "LOG_LEVEL", configKey: "logger.level" },
+    { envVar: "BUENO_LOG_LEVEL", configKey: "logger.level" },
+    {
+        envVar: "BUENO_LOG_PRETTY",
+        configKey: "logger.pretty",
+        transform: (v) => v === "true",
+    },
+    // Health
+    {
+        envVar: "BUENO_HEALTH_ENABLED",
+        configKey: "health.enabled",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_HEALTH_PATH", configKey: "health.healthPath" },
+    { envVar: "BUENO_READY_PATH", configKey: "health.readyPath" },
+    // Metrics
+    {
+        envVar: "BUENO_METRICS_ENABLED",
+        configKey: "metrics.enabled",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_METRICS_INTERVAL",
+        configKey: "metrics.collectInterval",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    // Telemetry
+    {
+        envVar: "BUENO_TELEMETRY_ENABLED",
+        configKey: "telemetry.enabled",
+        transform: (v) => v === "true",
+    },
+    { envVar: "BUENO_SERVICE_NAME", configKey: "telemetry.serviceName" },
+    { envVar: "BUENO_OTEL_ENDPOINT", configKey: "telemetry.endpoint" },
+    { envVar: "OTEL_EXPORTER_OTLP_ENDPOINT", configKey: "telemetry.endpoint" },
+    // Observability
+    {
+        envVar: "BUENO_OBSERVABILITY_ENABLED",
+        configKey: "observability.enabled",
+        transform: (v) => v === "true",
+    },
+    {
+        envVar: "BUENO_OBSERVABILITY_BREADCRUMBS_SIZE",
+        configKey: "observability.breadcrumbsSize",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_OBSERVABILITY_IGNORE_STATUS_CODES",
+        configKey: "observability.ignoreStatusCodes",
+        transform: (v) => v
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)
+            .map((s) => Number.parseInt(s, 10)),
+    },
+    // Frontend
+    {
+        envVar: "BUENO_FRONTEND_PORT",
+        configKey: "frontend.port",
+        transform: (v) => Number.parseInt(v, 10),
+    },
+    {
+        envVar: "BUENO_HMR",
+        configKey: "frontend.hmr",
+        transform: (v) => v === "true",
+    },
+];
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

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

package/dist/config/validation.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Configuration validation for Bueno Framework
+ * Supports Standard Schema validators (Zod, Valibot, ArkType)
+ */
+import type { StandardIssue, StandardSchema } from "../types";
+import type { BuenoConfig, DeepPartial } from "./types";
+/**
+ * Validation result
+ */
+export interface ConfigValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Validation errors if any */
+    errors: ConfigValidationError[];
+    /** Warnings (non-critical issues) */
+    warnings: ConfigValidationWarning[];
+}
+/**
+ * Validation error
+ */
+export interface ConfigValidationError {
+    /** Error message */
+    message: string;
+    /** Path to the invalid field */
+    path?: string;
+    /** Expected type or value */
+    expected?: string;
+    /** Actual value received */
+    received?: unknown;
+    /** Original issue from schema validator */
+    issue?: StandardIssue;
+}
+/**
+ * Validation warning
+ */
+export interface ConfigValidationWarning {
+    /** Warning message */
+    message: string;
+    /** Path to the field */
+    path?: string;
+}
+/**
+ * Check if a value is a Standard Schema
+ */
+export declare function isStandardSchema(value: unknown): value is StandardSchema;
+/**
+ * Validate config against a Standard Schema
+ */
+export declare function validateWithSchema<T>(config: unknown, schema: StandardSchema<T>): Promise<ConfigValidationResult>;
+/**
+ * Validation rule
+ */
+interface ValidationRule {
+    /** Path to the field to validate */
+    path: string;
+    /** Validation function */
+    validate: (value: unknown, config: DeepPartial<BuenoConfig>) => ValidationResult;
+}
+/**
+ * Validation result from a rule
+ */
+interface ValidationResult {
+    valid: boolean;
+    message?: string;
+    expected?: string;
+    received?: unknown;
+}
+/**
+ * Validate config using default rules
+ */
+export declare function validateConfigDefaults(config: DeepPartial<BuenoConfig>): ConfigValidationResult;
+/**
+ * Validate configuration
+ * Supports both Standard Schema and default validation rules
+ */
+export declare function validateConfig<T extends BuenoConfig = BuenoConfig>(config: unknown, schema?: StandardSchema<T>): Promise<ConfigValidationResult>;
+/**
+ * Validate configuration synchronously
+ * Note: Standard Schema validation may be async, so this only works with default rules
+ */
+export declare function validateConfigSync(config: DeepPartial<BuenoConfig>): ConfigValidationResult;
+/**
+ * Create a validation error with helpful message
+ */
+export declare function createConfigError(result: ConfigValidationResult): ConfigValidationError;
+/**
+ * Format validation errors for display
+ */
+export declare function formatValidationErrors(errors: ConfigValidationError[]): string;
+/**
+ * Assert that configuration is valid
+ * Throws an error if validation fails
+ */
+export declare function assertValidConfig<T extends BuenoConfig = BuenoConfig>(config: unknown, schema?: StandardSchema<T>): Promise<void>;
+/**
+ * Add custom validation rules
+ */
+export declare function createCustomValidator(rules: ValidationRule[]): (config: DeepPartial<BuenoConfig>) => ConfigValidationResult;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/config/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/config/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,+BAA+B;IAC/B,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,qCAAqC;IACrC,QAAQ,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAQxE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACzC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAsBjC;AAmVD;;GAEG;AACH,UAAU,cAAc;IACvB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,QAAQ,EAAE,CACT,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,KAC5B,gBAAgB,CAAC;CACtB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAsBD;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,GAC9B,sBAAsB,CA0CxB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACvE,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAQjC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,GAC9B,sBAAsB,CAExB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,sBAAsB,GAC5B,qBAAqB,CAevB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,qBAAqB,EAAE,GAC7B,MAAM,CAoBR;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC1E,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,cAAc,EAAE,GACrB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,KAAK,sBAAsB,CAwB9D"}