@buenojs/bueno 0.8.10 → 0.8.11

package/dist/types/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Core type definitions for Bueno Framework
+ */
+export type HTTPMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+export type StatusCode = 200 | 201 | 202 | 204 | 301 | 302 | 303 | 307 | 308 | 400 | 401 | 403 | 404 | 405 | 409 | 422 | 429 | 500 | 502 | 503 | 504;
+export type PathParams = Record<string, string>;
+export type RouteHandler<T = unknown, C extends object = import("../context").Context> = (context: C) => T | Promise<T>;
+export type RoutePath = string;
+export interface RouteDefinition {
+    method: HTTPMethod;
+    path: RoutePath;
+    handler: RouteHandler;
+    middleware?: MiddlewareHandler[];
+}
+export type MiddlewareHandler<T = unknown> = (context: unknown, next: () => Promise<unknown>) => T | Promise<T>;
+export type MiddlewareChain = MiddlewareHandler[];
+/**
+ * Typed middleware function that receives a Context
+ */
+export type Middleware<T = Response> = (context: import("../context").Context, next: () => Promise<Response>) => T | Promise<T>;
+export type Token<T = unknown> = string | symbol | (abstract new (...args: unknown[]) => T);
+export interface Provider<T = unknown> {
+    token: Token<T>;
+    useClass?: abstract new (...args: unknown[]) => T;
+    useValue?: T;
+    useFactory?: (...args: unknown[]) => T | Promise<T>;
+    inject?: Token[];
+    scope?: "singleton" | "transient" | "request";
+}
+export interface ModuleMetadata {
+    imports?: Token[];
+    providers?: Provider[];
+    controllers?: Token[];
+    exports?: Token[];
+}
+export interface ContextVariableMap {
+    [key: string]: unknown;
+}
+export interface ContextDefaults {
+    status: StatusCode;
+    headers: Headers;
+}
+/**
+ * Standard Schema v1 interface
+ * Works with Zod 4, Valibot v1, ArkType, Typia, and any Standard Schema compliant validator
+ */
+export interface StandardSchema<Input = unknown, Output = Input> {
+    readonly "~standard": {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown, options?: StandardSchemaOptions) => StandardResult<Output> | Promise<StandardResult<Output>>;
+        readonly types?: StandardTypes<Input, Output>;
+    };
+}
+export interface StandardSchemaOptions {
+    readonly libraryOptions?: Record<string, unknown>;
+}
+export interface StandardTypes<Input = unknown, Output = Input> {
+    readonly input: Input;
+    readonly output: Output;
+}
+export type StandardResult<Output> = StandardSuccessResult<Output> | StandardFailureResult;
+export interface StandardSuccessResult<Output> {
+    readonly value: Output;
+    readonly issues?: undefined;
+}
+export interface StandardFailureResult {
+    readonly issues: ReadonlyArray<StandardIssue>;
+}
+export interface StandardIssue {
+    readonly message: string;
+    readonly path?: ReadonlyArray<PropertyKey | StandardPathSegment>;
+}
+export interface StandardPathSegment {
+    readonly key: PropertyKey;
+}
+export type ValidationTarget = "body" | "query" | "params" | "headers" | "cookies";
+export type InferInput<Schema extends StandardSchema> = NonNullable<Schema["~standard"]["types"]>["input"];
+export type InferOutput<Schema extends StandardSchema> = NonNullable<Schema["~standard"]["types"]>["output"];
+export type DatabaseDriver = "postgresql" | "mysql" | "sqlite";
+export interface DatabaseConfig {
+    url: string;
+    pool?: {
+        min?: number;
+        max?: number;
+    };
+}
+export interface ServerConfig {
+    port?: number;
+    hostname?: string;
+    development?: {
+        hmr?: boolean;
+        console?: boolean;
+    };
+}
+export interface AppOptions {
+    server?: ServerConfig;
+    database?: DatabaseConfig;
+}
+export interface RPCClientConfig {
+    baseUrl: string;
+    headers?: Record<string, string>;
+}
+export declare class BuenoError extends Error {
+    statusCode: StatusCode;
+    code?: string | undefined;
+    constructor(message: string, statusCode?: StatusCode, code?: string | undefined);
+}
+export declare class ValidationError extends BuenoError {
+    issues: StandardIssue[];
+    constructor(message: string, issues: StandardIssue[]);
+}
+export declare class NotFoundError extends BuenoError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6MH,0CAA0C;AAE1C,MAAM,OAAO,UAAW,SAAQ,KAAK;IAG5B;IACA;IAHR,YACC,OAAe,EACR,aAAyB,GAAG,EAC5B,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAkB;QAC5B,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,CAAC;CACD;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAGtC;IAFR,YACC,OAAe,EACR,MAAuB;QAE9B,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAFjC,WAAM,GAAN,MAAM,CAAiB;QAG9B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC5C,YAAY,OAAO,GAAG,WAAW;QAChC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD"}

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> = {
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly success: false;
+    readonly 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/index.js

@@ -0,0 +1,276 @@
+/**
+ * Validation System
+ *
+ * Multi-validator support using Standard Schema interface.
+ * Works with Zod 4, Valibot v1, ArkType, Typia, and any Standard Schema compliant library.
+ */
+// ============= Core Validation Function =============
+/**
+ * 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 async function validate(schema, data) {
+    try {
+        const result = await Promise.resolve(schema["~standard"].validate(data));
+        if ("value" in result) {
+            return { success: true, data: result.value };
+        }
+        return {
+            success: false,
+            issues: [...result.issues],
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            issues: [
+                {
+                    message: error instanceof Error ? error.message : "Validation failed",
+                },
+            ],
+        };
+    }
+}
+/**
+ * Synchronous validation (for sync validators only)
+ */
+export function validateSync(schema, data) {
+    const result = schema["~standard"].validate(data);
+    // Check if it's a Promise (async validator)
+    if (result instanceof Promise) {
+        throw new Error("Schema uses async validation. Use validate() instead.");
+    }
+    if ("value" in result) {
+        return { success: true, data: result.value };
+    }
+    return { success: false, issues: [...result.issues] };
+}
+// ============= Request Validation Functions =============
+/**
+ * Validate request body
+ */
+export async function validateBody(context, schema) {
+    try {
+        const body = await context.body();
+        return validate(schema, body);
+    }
+    catch (error) {
+        return {
+            success: false,
+            issues: [{ message: "Failed to parse request body" }],
+        };
+    }
+}
+/**
+ * Validate query parameters
+ */
+export function validateQuery(context, schema) {
+    return validateSync(schema, context.query);
+}
+/**
+ * Validate path parameters
+ */
+export function validateParams(context, schema) {
+    return validateSync(schema, context.params);
+}
+/**
+ * Validate headers
+ */
+export function validateHeaders(context, schema) {
+    const headers = {};
+    context.req.headers.forEach((value, key) => {
+        headers[key] = value;
+    });
+    return validateSync(schema, headers);
+}
+// ============= Validation Middleware =============
+/**
+ * Create validation middleware
+ */
+export function createValidator(options) {
+    return async (context, next) => {
+        // Validate body
+        if (options.body) {
+            const result = await validateBody(context, options.body);
+            if (!result.success) {
+                return context
+                    .status(400)
+                    .json({ error: "Validation failed", issues: result.issues });
+            }
+            context.set("validatedBody", result.data);
+        }
+        // Validate query
+        if (options.query) {
+            const result = validateQuery(context, options.query);
+            if (!result.success) {
+                return context
+                    .status(400)
+                    .json({ error: "Validation failed", issues: result.issues });
+            }
+            context.set("validatedQuery", result.data);
+        }
+        // Validate params
+        if (options.params) {
+            const result = validateParams(context, options.params);
+            if (!result.success) {
+                return context
+                    .status(400)
+                    .json({ error: "Validation failed", issues: result.issues });
+            }
+            context.set("validatedParams", result.data);
+        }
+        // Validate headers
+        if (options.headers) {
+            const result = validateHeaders(context, options.headers);
+            if (!result.success) {
+                return context
+                    .status(400)
+                    .json({ error: "Validation failed", issues: result.issues });
+            }
+            context.set("validatedHeaders", result.data);
+        }
+        return next();
+    };
+}
+// ============= Decorator Helpers =============
+/**
+ * Body validation decorator for route handlers
+ */
+export function WithBody(schema) {
+    return (_target, _propertyKey, descriptor) => {
+        const original = descriptor.value;
+        descriptor.value = async function (context) {
+            const result = await validateBody(context, schema);
+            if (!result.success) {
+                return context
+                    .status(400)
+                    .json({ error: "Validation failed", issues: result.issues });
+            }
+            context.set("body", result.data);
+            return original.call(this, context);
+        };
+        return descriptor;
+    };
+}
+/**
+ * Query validation decorator for route handlers
+ */
+export function WithQuery(schema) {
+    return (_target, _propertyKey, descriptor) => {
+        const original = descriptor.value;
+        descriptor.value = async function (context) {
+            const result = validateQuery(context, schema);
+            if (!result.success) {
+                return context
+                    .status(400)
+                    .json({ error: "Validation failed", issues: result.issues });
+            }
+            context.set("query", result.data);
+            return original.call(this, context);
+        };
+        return descriptor;
+    };
+}
+// ============= Type Guards =============
+/**
+ * Check if a value is a Standard Schema
+ */
+export function isStandardSchema(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "~standard" in value &&
+        typeof value["~standard"]?.validate === "function");
+}
+// ============= Utility: Assert Schema =============
+/**
+ * Assert that a schema implements Standard Schema
+ */
+export function assertStandardSchema(schema, name = "Schema") {
+    if (!isStandardSchema(schema)) {
+        throw new Error(`${name} must implement Standard Schema interface. Supported: Zod 4+, Valibot v1+, ArkType, Typia 7+`);
+    }
+}
+// ============= Environment Variable Validation =============
+/**
+ * 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 async function validateEnv(schema, envVars) {
+    try {
+        // Validate the environment variables
+        const result = await validate(schema, envVars);
+        if (!result.success) {
+            // Format error messages with context
+            const formattedIssues = result.issues.map((issue) => {
+                const path = issue.path?.join(".") || "root";
+                return {
+                    ...issue,
+                    message: `Environment variable validation failed for ${path}: ${issue.message}`,
+                };
+            });
+            return {
+                success: false,
+                issues: formattedIssues,
+            };
+        }
+        return result;
+    }
+    catch (error) {
+        return {
+            success: false,
+            issues: [
+                {
+                    message: `Environment variable validation failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+        };
+    }
+}
+/**
+ * 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 function validateEnvSync(schema, envVars) {
+    try {
+        // Validate the environment variables
+        const result = validateSync(schema, envVars);
+        if (!result.success) {
+            // Format error messages with context
+            const formattedIssues = result.issues.map((issue) => {
+                const path = issue.path?.join(".") || "root";
+                return {
+                    ...issue,
+                    message: `Environment variable validation failed for ${path}: ${issue.message}`,
+                };
+            });
+            return {
+                success: false,
+                issues: formattedIssues,
+            };
+        }
+        return result;
+    }
+    catch (error) {
+        return {
+            success: false,
+            issues: [
+                {
+                    message: `Environment variable validation failed: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

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