@buenojs/bueno 0.8.6 → 0.8.8

package/dist/validation/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Validation System
+ *
+ * Multi-validator support using Standard Schema interface.
+ * Works with Zod 4, Valibot v1, ArkType, Typia, and any Standard Schema compliant library.
+ */
+import type { Context } from "../context";
+import type { Middleware, StandardIssue, StandardSchema } from "../types";
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    issues: StandardIssue[];
+};
+export interface ValidatorOptions {
+    body?: StandardSchema;
+    query?: StandardSchema;
+    params?: StandardSchema;
+    headers?: StandardSchema;
+}
+/**
+ * Validate data against any Standard Schema compliant schema
+ *
+ * Supports:
+ * - Zod 4+ (zod)
+ * - Valibot v1+ (valibot)
+ * - ArkType (arktype)
+ * - Typia 7+ (typia) - use typia.createValidate<T>() for Standard Schema compatibility
+ * - Any library implementing Standard Schema
+ */
+export declare function validate<T>(schema: StandardSchema<unknown, T>, data: unknown): Promise<ValidationResult<T>>;
+/**
+ * Synchronous validation (for sync validators only)
+ */
+export declare function validateSync<T>(schema: StandardSchema<unknown, T>, data: unknown): ValidationResult<T>;
+/**
+ * Validate request body
+ */
+export declare function validateBody<T>(context: Context, schema: StandardSchema<unknown, T>): Promise<ValidationResult<T>>;
+/**
+ * Validate query parameters
+ */
+export declare function validateQuery<T>(context: Context, schema: StandardSchema<unknown, T>): ValidationResult<T>;
+/**
+ * Validate path parameters
+ */
+export declare function validateParams<T>(context: Context, schema: StandardSchema<unknown, T>): ValidationResult<T>;
+/**
+ * Validate headers
+ */
+export declare function validateHeaders<T>(context: Context, schema: StandardSchema<unknown, T>): ValidationResult<T>;
+/**
+ * Create validation middleware
+ */
+export declare function createValidator(options: ValidatorOptions): Middleware;
+/**
+ * Body validation decorator for route handlers
+ */
+export declare function WithBody(schema: StandardSchema): (target: unknown, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Query validation decorator for route handlers
+ */
+export declare function WithQuery(schema: StandardSchema): (target: unknown, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Check if a value is a Standard Schema
+ */
+export declare function isStandardSchema(value: unknown): value is StandardSchema;
+/**
+ * Assert that a schema implements Standard Schema
+ */
+export declare function assertStandardSchema(schema: unknown, name?: string): asserts schema is StandardSchema;
+/**
+ * Validate environment variables against a schema
+ *
+ * @param schema - Validation schema for environment variables
+ * @param envVars - Environment variables to validate
+ * @returns Validation result with transformed values or error details
+ */
+export declare function validateEnv<T>(schema: StandardSchema<unknown, T>, envVars: Record<string, string>): Promise<ValidationResult<T>>;
+/**
+ * Validate environment variables with detailed error reporting
+ *
+ * @param schema - Validation schema for environment variables
+ * @param envVars - Environment variables to validate
+ * @returns Validation result with transformed values or detailed error information
+ */
+export declare function validateEnvSync<T>(schema: StandardSchema<unknown, T>, envVars: Record<string, string>): ValidationResult<T>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/validation/schemas.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Built-in Schema System
+ * Lightweight validation schema builder for common use cases.
+ * No external dependencies required.
+ */
+import type { StandardResult } from "../types";
+export type FieldValidator = (value: unknown) => {
+    valid: boolean;
+    error?: string;
+    value?: unknown;
+};
+export interface SchemaDefinition {
+    [key: string]: FieldValidator | SchemaDefinition | undefined;
+}
+export declare const Fields: {
+    /**
+     * String field validators
+     */
+    string: (options?: {
+        min?: number;
+        max?: number;
+        pattern?: RegExp;
+        email?: boolean;
+        url?: boolean;
+        uuid?: boolean;
+        optional?: boolean;
+    }) => (value: unknown) => {
+        valid: boolean;
+        error: string;
+        value?: undefined;
+    } | {
+        valid: boolean;
+        value: string;
+        error?: undefined;
+    };
+    /**
+     * Number field validators (coerces strings to numbers)
+     */
+    number: (options?: {
+        min?: number;
+        max?: number;
+        integer?: boolean;
+        positive?: boolean;
+        optional?: boolean;
+        default?: number;
+        coerce?: boolean;
+    }) => (value: unknown, validateOnly?: boolean) => {
+        valid: boolean;
+        value: number;
+        error?: undefined;
+    } | {
+        valid: boolean;
+        error: string;
+        value?: undefined;
+    };
+    /**
+     * Boolean field validator
+     */
+    boolean: (options?: {
+        optional?: boolean;
+    }) => (value: unknown) => {
+        valid: boolean;
+        error: string;
+        value?: undefined;
+    } | {
+        valid: boolean;
+        value: boolean;
+        error?: undefined;
+    };
+    /**
+     * Array field validators
+     */
+    array: (options?: {
+        min?: number;
+        max?: number;
+        itemValidator?: FieldValidator;
+        optional?: boolean;
+    }) => (value: unknown) => {
+        valid: boolean;
+        error: string;
+        value?: undefined;
+    } | {
+        valid: boolean;
+        value: any[];
+        error?: undefined;
+    };
+    /**
+     * Enum field validator
+     */
+    enum: (values: readonly (string | number)[], options?: {
+        optional?: boolean;
+    }) => (value: unknown) => {
+        valid: boolean;
+        error: string;
+        value?: undefined;
+    } | {
+        valid: boolean;
+        value: unknown;
+        error?: undefined;
+    };
+    /**
+     * Custom validator function
+     */
+    custom: (validate: (value: unknown) => boolean, message?: string) => (value: unknown) => {
+        valid: boolean;
+        value: unknown;
+        error?: undefined;
+    } | {
+        valid: boolean;
+        error: string;
+        value?: undefined;
+    };
+    /**
+     * Environment variable validators
+     */
+    env: {
+        /**
+         * Required environment variable validator
+         */
+        required: (options?: {
+            optional?: boolean;
+        }) => (value: unknown) => {
+            valid: boolean;
+            error: string;
+            value?: undefined;
+        } | {
+            valid: boolean;
+            value: unknown;
+            error?: undefined;
+        };
+        /**
+         * Port number validator (1-65535)
+         */
+        port: (options?: {
+            optional?: boolean;
+        }) => (value: unknown) => {
+            valid: boolean;
+            error: string;
+            value?: undefined;
+        } | {
+            valid: boolean;
+            value: number;
+            error?: undefined;
+        };
+        /**
+         * URL validator
+         */
+        url: (options?: {
+            optional?: boolean;
+        }) => (value: unknown) => {
+            valid: boolean;
+            error: string;
+            value?: undefined;
+        } | {
+            valid: boolean;
+            value: string;
+            error?: undefined;
+        };
+        /**
+         * Database URL validator
+         */
+        databaseUrl: (options?: {
+            optional?: boolean;
+        }) => (value: unknown) => {
+            valid: boolean;
+            error: string;
+            value?: undefined;
+        } | {
+            valid: boolean;
+            value: string;
+            error?: undefined;
+        };
+        /**
+         * Boolean validator
+         */
+        boolean: (options?: {
+            optional?: boolean;
+        }) => (value: unknown) => {
+            valid: boolean;
+            error: string;
+            value?: undefined;
+        } | {
+            valid: boolean;
+            value: boolean;
+            error?: undefined;
+        };
+        /**
+         * Number validator
+         */
+        number: (options?: {
+            min?: number;
+            max?: number;
+            optional?: boolean;
+            integer?: boolean;
+        }) => (value: unknown) => {
+            valid: boolean;
+            error: string;
+            value?: undefined;
+        } | {
+            valid: boolean;
+            value: number;
+            error?: undefined;
+        };
+    };
+};
+/**
+ * Built-in schema validator
+ * Simple, zero-dependency schema validation
+ */
+export declare class Schema {
+    private definition;
+    constructor(definition: SchemaDefinition);
+    /**
+     * Create a new schema from field definitions
+     */
+    static object<T extends SchemaDefinition>(definition: T): Schema;
+    /**
+     * Validate data synchronously
+     */
+    validateSync(data: unknown): StandardResult<Record<string, unknown>>;
+    /**
+     * Validate data asynchronously
+     * Currently same as sync, but allows for async validators in future
+     */
+    validate(data: unknown): Promise<StandardResult<Record<string, unknown>>>;
+    /**
+     * Implement Standard Schema interface for compatibility with @buenojs/bueno validators
+     */
+    get ["~standard"](): {
+        validate: (data: unknown) => StandardResult<Record<string, unknown>>;
+        version: number;
+    };
+}
+/**
+ * Create a schema object
+ * Alias for Schema.object() for convenience
+ */
+export declare function schema<T extends SchemaDefinition>(definition: T): Schema;
+/**
+ * Standard environment variable schema for Bueno Framework
+ */
+export declare const envSchema: Schema;
+//# sourceMappingURL=schemas.d.ts.map

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

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

package/dist/websocket/index.d.ts

@@ -0,0 +1,252 @@
+/**
+ * WebSocket Helpers
+ *
+ * Utilities for WebSocket connections, pub/sub patterns,
+ * and real-time communication in Bueno applications.
+ */
+export interface WebSocketData {
+    id: string;
+    userId?: string;
+    [key: string]: unknown;
+}
+export interface WebSocketMessage {
+    type: string;
+    payload: unknown;
+    timestamp: number;
+}
+export interface WebSocketOptions {
+    idleTimeout?: number;
+    maxPayloadLength?: number;
+    perMessageDeflate?: boolean;
+}
+export type WebSocketHandler = (ws: Bun.ServerWebSocket<WebSocketData>, message: WebSocketMessage) => void | Promise<void>;
+export type OpenHandler = (ws: Bun.ServerWebSocket<WebSocketData>) => void | Promise<void>;
+export type CloseHandler = (ws: Bun.ServerWebSocket<WebSocketData>, code: number, reason: string) => void | Promise<void>;
+export type ErrorHandler = (ws: Bun.ServerWebSocket<WebSocketData>, error: Error) => void | Promise<void>;
+export interface WebSocketServerOptions extends WebSocketOptions {
+    onMessage?: WebSocketHandler;
+    onOpen?: OpenHandler;
+    onClose?: CloseHandler;
+    onError?: ErrorHandler;
+}
+export declare class WebSocketServer {
+    private options;
+    private connections;
+    private rooms;
+    private messageHandlers;
+    constructor(options?: WebSocketServerOptions);
+    /**
+     * Get Bun WebSocket configuration
+     */
+    getWebSocketConfig(): Bun.WebSocketHandler<WebSocketData>;
+    /**
+     * Register a message type handler
+     */
+    on(type: string, handler: WebSocketHandler): this;
+    /**
+     * Broadcast to all connections
+     */
+    broadcast(type: string, payload: unknown): void;
+    /**
+     * Send to specific connection
+     */
+    send(connectionId: string, type: string, payload: unknown): boolean;
+    /**
+     * Broadcast to a room
+     */
+    broadcastToRoom(room: string, type: string, payload: unknown): void;
+    /**
+     * Join a room
+     */
+    joinRoom(connectionId: string, room: string): void;
+    /**
+     * Leave a room
+     */
+    leaveRoom(connectionId: string, room: string): void;
+    /**
+     * Get room members
+     */
+    getRoomMembers(room: string): string[];
+    /**
+     * Get all connection IDs
+     */
+    getConnectionIds(): string[];
+    /**
+     * Get connection count
+     */
+    get connectionCount(): number;
+    /**
+     * Check if connection exists
+     */
+    hasConnection(connectionId: string): boolean;
+    /**
+     * Close a connection
+     */
+    closeConnection(connectionId: string, code?: number, reason?: string): boolean;
+    /**
+     * Close all connections
+     */
+    closeAll(code?: number, reason?: string): void;
+}
+export interface WebSocketClientOptions {
+    url: string;
+    protocols?: string | string[];
+    reconnect?: boolean;
+    reconnectInterval?: number;
+    maxReconnectAttempts?: number;
+    onOpen?: () => void;
+    onClose?: (event: CloseEvent) => void;
+    onMessage?: (message: WebSocketMessage) => void;
+    onError?: (event: Event) => void;
+}
+export declare class WebSocketClient {
+    private ws;
+    private options;
+    private reconnectAttempts;
+    private shouldReconnect;
+    private messageQueue;
+    constructor(options: WebSocketClientOptions);
+    /**
+     * Connect to WebSocket server
+     */
+    connect(): Promise<void>;
+    /**
+     * Attempt to reconnect
+     */
+    private attemptReconnect;
+    /**
+     * Send a message
+     */
+    send(type: string, payload: unknown): void;
+    /**
+     * Send raw data
+     */
+    sendRaw(data: string | ArrayBuffer | Blob): Promise<void>;
+    /**
+     * Close the connection
+     */
+    close(code?: number, reason?: string): void;
+    /**
+     * Check if connected
+     */
+    get isConnected(): boolean;
+    /**
+     * Get ready state
+     */
+    get readyState(): number;
+}
+export interface PubSubConfig {
+    driver?: "redis" | "memory";
+    url?: string;
+    keyPrefix?: string;
+    reconnect?: boolean;
+    reconnectInterval?: number;
+    maxReconnectAttempts?: number;
+}
+export interface PubSubMessage {
+    channel: string;
+    pattern?: string;
+    data: unknown;
+    timestamp: number;
+}
+export type PubSubCallback = (message: PubSubMessage) => void | Promise<void>;
+export declare class PubSub {
+    private driver;
+    private driverType;
+    private _isConnected;
+    constructor(config?: PubSubConfig);
+    /**
+     * Connect to the pub/sub backend (Redis only)
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the pub/sub backend
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    get isConnected(): boolean;
+    /**
+     * Get the driver type
+     */
+    getDriverType(): "redis" | "memory";
+    /**
+     * Publish a message to a channel
+     * Returns the number of subscribers that received the message
+     */
+    publish(channel: string, data: unknown): Promise<number>;
+    /**
+     * Subscribe to a channel
+     * Returns an unsubscribe function
+     */
+    subscribe(channel: string, callback: PubSubCallback): Promise<() => void>;
+    /**
+     * Subscribe to channels matching a pattern
+     * Supports * (any characters) and ? (single character)
+     * Returns an unsubscribe function
+     */
+    psubscribe(pattern: string, callback: PubSubCallback): Promise<() => void>;
+    /**
+     * Unsubscribe all callbacks from a channel
+     */
+    unsubscribe(channel: string): Promise<void>;
+    /**
+     * Unsubscribe all callbacks from a pattern
+     */
+    punsubscribe(pattern: string): Promise<void>;
+    /**
+     * Get subscriber count for a specific channel
+     */
+    getChannelSubscribers(channel: string): number;
+    /**
+     * Get subscriber count for a specific pattern
+     */
+    getPatternSubscribers(pattern: string): number;
+    /**
+     * Get total subscriber count across all channels and patterns
+     */
+    getTotalSubscribers(): number;
+    /**
+     * Clear all subscriptions
+     */
+    clear(): Promise<void>;
+    /**
+     * Destroy the pub/sub instance and release resources
+     */
+    destroy(): void;
+}
+/**
+ * Create a WebSocket server
+ */
+export declare function createWebSocketServer(options?: WebSocketServerOptions): WebSocketServer;
+/**
+ * Create a WebSocket client
+ */
+export declare function createWebSocketClient(options: WebSocketClientOptions): WebSocketClient;
+/**
+ * Create a pub/sub instance
+ * @param config Configuration options including driver type and Redis URL
+ */
+export declare function createPubSub(config?: PubSubConfig): PubSub;
+/**
+ * Create a Redis pub/sub instance (convenience function)
+ */
+export declare function createRedisPubSub(url: string, options?: Omit<PubSubConfig, "driver" | "url">): PubSub;
+/**
+ * Create an in-memory pub/sub instance (convenience function)
+ */
+export declare function createMemoryPubSub(): PubSub;
+/**
+ * Check if request is a WebSocket upgrade request
+ */
+export declare function isWebSocketRequest(request: Request): boolean;
+/**
+ * Generate WebSocket connection ID
+ */
+export declare function generateConnectionId(): string;
+/**
+ * Create WebSocket data for new connection
+ */
+export declare function createWebSocketData(data?: Partial<WebSocketData>): WebSocketData;
+//# sourceMappingURL=index.d.ts.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buenojs/bueno",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "description": "A Bun-Native Full-Stack Framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,7 +10,7 @@
     "access": "public"
   },
   "bin": {
-    "bueno": "./dist/cli/index.js"
+    "bueno": "./dist/cli/bin.js"
   },
   "exports": {
     ".": {
@@ -148,7 +148,7 @@
     "test:watch": "bun test --watch",
     "test:coverage": "bun test --coverage",
     "coverage": "bun test --coverage coverage/lcov.info",
-    "build": "rm -rf dist && bun build ./src/index.ts ./src/database/index.ts ./src/schema/index.ts ./src/migrations/index.ts ./src/orm/index.ts ./src/jobs/index.ts ./src/templates/index.ts ./src/template/index.ts ./src/openapi/index.ts ./src/notification/index.ts ./src/i18n/index.ts ./src/cli/bin.ts ./src/frontend/index.ts ./src/router/index.ts ./src/middleware/index.ts ./src/modules/index.ts ./src/telemetry/index.ts ./src/observability/index.ts ./src/graphql/index.ts ./src/lock/index.ts ./src/health/index.ts ./src/logger/index.ts ./src/metrics/index.ts ./src/rpc/index.ts ./src/context/index.ts ./src/container/index.ts ./src/testing/index.ts ./src/types/index.ts --outdir ./dist --target bun && test -d dist/src && (cp -r dist/src/* dist/ && rm -rf dist/src) || true",
+    "build": "rm -rf dist && bun build ./src/index.ts ./src/database/index.ts ./src/schema/index.ts ./src/migrations/index.ts ./src/orm/index.ts ./src/jobs/index.ts ./src/templates/index.ts ./src/template/index.ts ./src/openapi/index.ts ./src/notification/index.ts ./src/i18n/index.ts ./src/cli/bin.ts ./src/frontend/index.ts ./src/router/index.ts ./src/middleware/index.ts ./src/modules/index.ts ./src/telemetry/index.ts ./src/observability/index.ts ./src/graphql/index.ts ./src/lock/index.ts ./src/health/index.ts ./src/logger/index.ts ./src/metrics/index.ts ./src/rpc/index.ts ./src/context/index.ts ./src/container/index.ts ./src/testing/index.ts ./src/types/index.ts --outdir ./dist --target bun && test -d dist/src && (cp -r dist/src/* dist/ && rm -rf dist/src) || true && tsc --project tsconfig.declaration.json 2>&1 || true",
     "build:cli": "bun build ./src/cli/bin.ts ./src/frontend/index.ts ./src/router/index.ts ./src/middleware/index.ts ./src/modules/index.ts --outdir ./dist/cli --target bun",
     "typecheck": "tsc --noEmit",
     "lint": "bunx biome check ./src",